Configuring Runtime Observability

This topic guides you through the steps to configure Observability settings for your basic runtimes, runtime cluster, and runtime clouds to export telemetry data via OpenTelemetry.

note

Not supported for cloud attachments.

Prerequisites

1. Have a locally installed Boomi runtime.
2. Have Runtime Management privileges.

Observability Tooling Prerequisites

1. Install or reference a third party application monitoring tool that supports OpenTelemetry (list of supported vendors).
2. Connectivity details for the monitoring tool, including:
   1. URL and port
   2. Authentication - If required, typically will be a user name and password, or API token.
3. Optional: Instead of connecting directly to the monitoring tool, you can install and configure a local collector.

Configuration

1. From the Runtime Management page, click Observability from the menu options, then toggle the Enable Observability switch to on.
2. Configure global endpoint information to where telemetry data should be sent. Note this can be overridden per signal type below.
   1. URL - Endpoint for monitoring application or collector. Must be accessible to the runtime.
   2. Authentication Type - If applicable, the authentication type and credentials required to access the monitoring application or collector.
   3. Custom Headers (optional) - Used to send additional information to monitoring tools, such as custom authentication (e.g. PAI tokens) or other metadata
      1. Headers are key:value values. Key is required. Example:
         1. Key: X-api-key
         2. Value: 5c7284a7-36e8-475e-a2d9-dfae124c0962
      2. Maximum of 20 headers.
3. Enter configuration details to customize your observability settings.
   1. Enable and configure metrics telemetry export
      1. Enable metrics to begin exporting runtime application metrics.
      2. Optional - Override metrics endpoint if need to send the metrics to a different monitoring endpoint.
      3. Optional - Configure advanced settings to optimize transmission as needed.
   2. Enable and configure logs telemetry export.
      1. Enable logs to begin exporting runtime and process execution logs.
      2. Optional - Override logs endpoint if need to send the logs to a different monitoring endpoint.
      3. Choose to export all logs or only selected logs.
      4. Optional - Configure advanced settings to optimize transmission as needed.
   3. Enable and configure traces telemetry export.
      1. Enable traces to begin exporting process execution traces.
      2. Optional - Override traces endpoint if need the traces to send to a different monitoring endpoint.
      3. Choose to export traces for all processes or only selected processes.
      4. Optional - Configure advanced settings to optimize transmission as needed.
4. Save
   1. Optional - Select Yes, restart the plugin now.
      NOTE: When enabling observability, the observability plugin must be restarted. Keep in mind observability data is not generated nor exported while the runtime or plugin is restarting.
5. SUCCCESS! Your observability settings are now configured.

You can also configure observability via the RuntimeObservabilitySettings API.